DECnet-RSX  User's  and 
ProQ rammer's  Minlreference  Guide 


AA-X923A-TC 


November  1983 


To  order  additional  copies  of  this  document  contact  your  local 
Digital  Equipment  Corporation  Sales  Office 


digital  equipment  corporation  •  maynord,  massachusetts 


Copyright     1983  Digital  Equipment  Corporation 


EOIDDSD 


CONVENTiOIIS  USiO  IN  THIS  GUIOi 

[]  enclose  optional  arguments 

II  *"^'cate  that  only  one  of  the  enclosed  options  can  be  used 

...  ind'cate  that  the  r  receding  argument  can  be  repeated  . 

®  indicates  a  carriage  return. 

,ra/,c.e.  .o.«,ca.e  .0..S  .n  cod,ng  examples  an.  can  ,or.a,s,nd,ca,e  vana 


INVOKING  UmiTIES 

For  details,  refer  to  the  RSX  11  Ut,l,t>es  Manual  (See  exceptions  tor  RMT   n  tr^e  section  that  foMows  ) 

Invoking  a  utility: 

From  MCR         utilitynameml) 

From  DCL:        -MCR  uUlityname'*i3 

To  terminate  most  utilities  invoked  m  this  way   type  CTRl'g^. 

Issuing  a  single  utility  command  line: 

MCB    utintyname  commandstringKf\ 
MCR 

OCl    MCR  utiiityname  commandstringM^ 
DCL> 

Invoking  and  running  a  utility  using  an  Indirect  command  file 

«uf///fyname  (ft ^/eA7am©(/TRJiR£T  (TRace  option) 


Invoking  uninttall«d  utilitl^i: 

-RUN  $u^//fynameR£^ 
RMT  Utility 
Invoking  RMT  and  connecting  to  the  host  nude 


For  DECn^t-llM  and  0ECnet-1lM-PLUS: 


RMTRf^ 
Host   hostname  wf^ 


or     RMT  hostnam0^ 


For  DECnet-1  IS 


RUN  RMTm- 
Host   hostnarneM"^: 


Entenrig  CTRLC    causes  RMT  to  prompt  tor  input  (RMT    »  and  tnen  pass  control  to  the  CLI 
Disconnecting  from  the  host  node: 

-EXIT  RMT»tr  or     BYE«i:  Of    •BYE./HOLDMt 


Refer  to  Appendix  A  of  tr^e  DECnet  RSX  Gu/de  to  Us9r  Utilities  for  QlO  functions.  suOfuncttont.  restrictions  and  status  returns  for  t^4  HT 
driver 


NCP  USER  COMMANOS 


Keywords  (shown  m  uppercase)  can  De  abbreviated  to  the  first  3  letters  All  SHOW  corr^mands  can  be  directed  to  an  output  t\\e  by  adding  TO 
output-filename  at  the  end  of  the  command  (Fo'  detailed  command  descriptions  refer  to  the  DECnet  PSK  Guide  to  User  Ufiht>es  For  a 
complete  listing  o»  all  NCP  commands  and  parameters  refer  to  the  DECnet  RSX  Sysfem  Vfanagers  Guide  and  t^ie  DEC^et  RSM  System 
Manager  s  M'mreference  Guide  ) 


Local  remote  node  information: 


SHOW    [NODE  node-'d 
I   EXECUTOR 
ACTIVE  NODES 
KNtVVN  NODES 
ADJACENT  NODE 
SIGNIFICANT  NODES 


>i 


TELL 


\     M 


[status! 


> 


routing-node  td  SHOW 


NODE  node-id 
EXECUTOR 
ACTIVE  NODES 
KNOWN  NODES 
I    ADJACENT  NODE 

I  Significant  nodes 


STATUS 


1 


Line  circuit  informal    v: 


Alias  node  names 


Aisiitanca  in  using  NCP 


SHOW 


SHOW 


SET 


ACTIVE  LINES 
KNOWN  LINES 
LINE  hne-id 
SIGNIFICANT  LINES 

ACTIVE  CIRCUITS 
KNOWN  CIRCUITS 
CIRCUIT  C'rcwt->rt 
SiGNlFiCANT  CIRCUITS 

ALIAS  ahas-nams  DESTINATION  cfesA^ 


^■'VTTJ^^'^.'T         ■'  *-■  ^ 


nattonnode 


SHOW  J  AM^Sa'/ds-na.-^e 
KNC  'N  AIIAS6S 
ALL  ALIASES 


CLEAR 


I  Al.'AS  anas  name 
\  KNOWN  ALIASES 


HE 


''  f(; 


command 
omponent-typff 


}] 


Note       M£LP  fik     ftiuft  tm  on  L8  1 1  2| 


NR/FTS  FILE  DESCIIIPTOII  AND  COMMAND  FDflMATS 


Toi  ueidils.  teftfr  to  ifie  ucCne!  RSX  Gutde  to  user  utifives 
NFT  FTS  file  descriptor  format:        [nodespec  ]\filesper] 
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nodespec 


ttlespez 


nodename[  usend  oass\^ord  account]  : 
nodename[  userid  password  account  ]: 

device  [ufd]fiiename  type.version 


If  you  are  usmg  a  foreign  file  speciftcation  that  cannot  be  parsed  by  DECnet  RSX  NFT  i\  must  be  enclosed  m  double  quotes  '  t>f0§fi9C')  Refer 
to  this  cards  section  on  foreign  file  formats  or  to  each  systems  current  docum.enUUon  tor  correct  file  formats 

You  can  insert  a  hyphen  (-)  before  w'  to  continue  a  command  line  onto  an  addtt'Onal  Itoe   You  Ctn  'nsert  the  hypiien  at  any  pomt  tn  th# 
command  line 

NFT  Command  Formats 


NFT  operations  are  specified  by  primary  switches  Primary  switches  can  be  inserted  anyv^here  on  a  command  ime  Qualifying  switches  apply 
only  to  each  specific  input  file  to  which  they  are  appended  When  qualifying  switch(es)  are  specified  for  an  output  file  the  switch(esi  become 
the  defau'!  for  all  input  file(s)  m  the  command  unless  ovcrrid.  an  on  a  per  file  basis 


In  the  NFT  command  formats,  switch  denotes  one  (or  more)  of  the  foHowng  optional  qualttvsng  sw«tch(es). 

/AS  (transfer  m  ASCII  record  mode) 

/AX  (transfer  m  either  block  or  record  mode  based  on  remote  FAL  capabilities) 

/BK  (transfer  m  block  mode) 

/CO  (create  output  tile  with  contiguous  allocation} 

/\M  (transfc  in  image  record  model 

/NV  (specify  same  or  latest  version  number  tor  an  o-jtput  file) 

/PR  (set  or  change  a  file  s  protection  status) 

/RC  (transfer  files  a  record  at  a  time) 

/SP  (spool  flies  to  a  line  pnnteri 

/SU  (Supercede  contents  of  an  exist  ng  file) 

/LO  (display  file  names  as  they  are  executed) 

The  Append  Operation  -  AP  (append  files  to  end  of  existing  files) 

Format   np^t  outfile  !nf:lQl[Sf^itch][     .inin9n[s^itch\\  AH 

Qualifying  switches   /AS,  'AX,    BK.  /IM.  /PR     RC     SP     10 


(continued  on  next  pagei 


Th«  Copy  Operation  -  default  (file  transfer) 
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Format   Nfl   outtile  mfile1[switch][,    .infilen[switch\] 

Qualifying  switches:  /AS. /AX.  /BK,    CO.  /If^,  /NV,    PR,    RC.    SP     SU     LO 
Tho  D«leto  Operation  -  DE  (delete  fiieis)) 

Format   NFT   fileaesc1[  ...tiledescn\'DE[switch] 

Qualifying  switch    /LO 
The  Eiacuta  Operation  -  if.X  (execute  remote  Mleis)) 

Format   NFT   commandfile1[.     commandfil0n]'EX[s^itch] 

Qualifying  switch    ^LO 
The  Heip  Operation  -  ME  or  HELP  (hst/provide  mforr*    'on  on  subiectsi 

Format.  NFT -/HE  or  NFT  .HELP(sut)/ecfl 

Tt»e  Identify  Operation  -  /ID  (display  information  on  current  NFT  and  NFAR  version  numbers  type  of  operating  system  and  ttie  suppoM  DAP 
buffer  size,  and  optional  remote  FAL) 


Format   NFT   [nodBspec  ]/\0 


r-iry-rj^T^-r^-^ 


The  List  Directory  Operations  -  /LI,  .'FU,   BR,   AT  ^iist  directory  of  one  or  more  fiiei*")^  see  descriptions  beiu^i 


Format   NFT    [outfile    ]infile1[,    jnfilen] 


f\j[math\    I 

BR  M 

AT  J 


The  'LI  (list)  switch  lists  the  name,  size,  creation  date   and  optional  contiguous  and  locKed  indicators  for  files  on  a  remote  node 

The  'FU  (full  directory  listing)  switch  lists  the  name,  size  creation  date  optional  contiguous  and  locked  indicators  owner  protection  date 
last  modified,  and  revision  number  for  files  on  a  remote  node 


The    BR  (brief  fisting)  switch  lists  only  the  names  of  fiies  on  a  remote  node 

The  /AT  (attributes  listing)  switch  lists  the  file  organization  record  format  and  record  attributes  as  tvelS  as  the  information  if»ciu<led  m  a  full 
(/FU)  directory  listing. 

The  Rename  Operation  -  RE  (change  name  of  existing  file) 

Format   NFT   outfile  infile1[sy¥itch\[.    ./n/'/en[sw>fc^ll/RE 


Qualifying  switches   /NV,  /LO 


^continued  on  fient  page) 
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The  Set  Default  Operation  -   DF  (set  display  defaults) 


Format  NFT   [defaults]  Of 


The  Set  Protection  Operation  -  PR  ( set  change  file  protection^ 

Format  NFT  7//edesc1  ^Pnff»]f'SYp]{'OW  pl[  GRpll  WO  pipFOu^cl-H^ 

^^^   I ^''©tyescn  PR(nl{  SYp][/OWp!i  GRpll  WOpJl  fO  u>c]][5^ifch] 

Oualitving  switch    /LO 
The  Spool  Operation  -   SP  (spool  Me  to  line  prmfer) 

Format.  HFJ  >{outfil0   ]infilel[switch]l     .infii9n[smtch]]/SP 

Qualttytng  switches     AS.    AX,    Bk     IM    .NV     RC,    SU     LO 
The  Submit  Operation  -  SB  (copy.  sut)m(t.  and  delete  a  file) 

Format  NFT   outtile  commandtileS&is^itchl 

Qualifying  switches     AS,    AX.    BK.  /IM,  /NV.  ,RC.    LO 
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FTS  Command  Formats 

FTS  operations  are  spectfied  by  primiry  iv^itches  Pr;mary  sv^itc^es  can  be  (nserted  anywhere  on  a  command  fine  QuaJ'fy  ng  swtc^^e*  can  b« 
specified  for  input  tiles  only  and   once  inserted  m  the  comma'^d   become  the  default  for  the  ^est  o^  the  tommano   '^e   w.'i*e*s  o^e'^'dden 


In  the  FTS  commani  for  mats   s^ftc^  denotes  one  (or  more)  o*  t^e  foHowfng  optional  Quaitfytng  swttcNtl^ 

AF     (execute  rec,uest  after  specfied  time) 

Format    FTS   commandlme  ^f[ciaY-mnthfr\hrmin 
AS    (transfer  .r  ASCII  recurd  model 
/IM     (transfer  m  image  record  mode) 
'LO    fog  completion  messages^ 

Format   FTS    .  L0(  ^/espec] 

FTS    /   LO  or  FTS     NOLO  (dO  not  log  CompigtiO'-  m 
PR    (qjeue  request  at  specified  pricrity> 

Fc^mat    FTS     PR  pr»or(fv 
SE    (p'ocess  requests  according  to  'hput  sequence) 

Format    FTS    comm*  oc//rr)e  SE 


The  Append  Operation  -   AP  (append  fiies  to  end  of  e«ift»rtg  f»i#st 
Format   FTS   outfits  infill f{SMitch\[.     intif9r[smtch\\'AP 


Qualifying  S¥witches     AF     AS     iM     LO     PR     SE 


I^WHmued  or  ne«t  d«o») 


The  Copy  Operation      default  tMe  trdPSter) 

Format   FTS   oym/n   tr,h^^^i^^|Qf^y^     .tnM0n{smlch\\ 
Qudiifv.ng  st*itche»     Ah    fmS.    M   /LO.  'PH     $€ 

The  Delete  Opefiition       DE  (d«4«te  f<t#tsi> 

Forma?  A   FTS    f>i9aesc1{      nm<^$en\Dlis^ftcf:l 

forma*.  B   FTS   outhle   mht^  Dt\swiKh\  (transfer  and  a  ^^) 

QuaJiN  ng  swtcnes     AF     to     Pn     St 
The  Edit  Operation      EO  unfii&a  the  queuing  of  ^eque^tsr 

Format    FTS      ED 
v.***  Execute  Operation       EX  j©i«^ute  'emotr  ^'m%k) 

Format   FT§   command/'/e'(tHF#lef»|(     ,comm^tf*(Smm^\tm*^c*i\]1i)k 

Qud:'^'igii«|^»tf /4Mf,  ;/iQ,  ;PI|,  ,$i 
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■i^i>j"j?> /.:  --^  ■" 


The  Htip  Operation  -  /ME  or  HELP  <l.st/prov.de  .nfor,^,at.on  on  sub.ects) 

Format   FTS     HE  or  FTS    HELP[sut)/t*cfJ 
The  Identify  Operation  -  ID  i display  current  FTS  version  number) 

Format   FTS     ID 
The  Kill  Operation  -   Kl  (kill  request(s)) 

Format   FTS  lOb  /Kl  or  FTS   nodename     K\  or  FTS    VKI 
The  List  Operation  -  /LI  (list  pending  user  requests) 

Format   FTS   [nodename  ]/u 
The  Set  Default  Operation  -  OF  (set/dispiay  defaults) 

Format   FTS   [defaults]' Of 


iconi.nuet^  on  net!  09^9) 
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Th«  Spool  Operation  -   SP  tspoo'  file  to  line  printer) 

Format   FTS    \Oi4tfUe    ]mtfle1[sv^itch][      mfilen{sv¥itch]\  SP 

Qualtfying  switches     AF    'LO     PR     SE 
The  Submit  Operation  -   SB  (copy  submit  and  delete  a  Me) 

Format  FTS   outfiie  commancffitB\5wifch]'SB 

Qualifying  switches     af     LO     PR     SE 


WWIW  OfEIUTIIIfi  SYSTTl  FlU  nUNSm  FOfWUTS 

Not*:      Because  system  formats  are  subiect  to  change,  .t  .s  ^ 
File  specification  formats: 


.se  to  check  current  documentation  for  systems  w.th  which  you  are  networKmc 


IAS 

VAX  VMS 

RT-11 

RSTS  E 
TOPS  20 


dev  [ufd]fiiename  type  version 

dev  \dfrectory]f,iendme  type  version 

dev  filename  type 

dev  [ppn]Ulename  type 

dev    directory   filename  type  version 


(cofitinued  on  next  page) 
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Transfer  formats: 
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Notas:      •    System  output  is  printed  in  ted 

•    Many  systems  do  not  require  specification  of  account 


DECnel-lAS 
DECnet-VAX 


DECnet-RT 


DECnet  E 


NFT  noaename  uS9ri<i'passwor6^iiCCOunf  outf'fe  mfilem 

COPY  «t- 

From     riodBname  usend  password  tccounr  infifeH% 
T0,        ^od^nameusena  pass¥^ora  account    outtne'4'^ 

R  NFT«»^ 

COPY        ASCHiftJ 

From?     tnfile^^ 

To     ?     nod^namB  us9nd  password  account  outfttBlf^ 

NFT   COPY  nodBnmmm  outhtB  >nN90$ 
Node  nodenarne 
User   ppnm^ 
Password  password f*' 
Account    mr 


DECnet  20 


R  NfJptr 

NFT    COPY  >nf,ie  noaename  ouff//e  U««r  us#r«<| 

Account  acrounf  »c!5 


Examples: 


Tr«ntl«r  from  VMS  to  RSX  using  OECnti-VAX 

♦  FrtUt      €^V    0eAOir>ritLS0N15Aflf»Lt.?K? 

♦  Tot  tiiii«"t2yv#2vOJ    f»ASS-;ti^ 

Flit    SA«PLi»fXf   «^4|l    gg   ^^1^^    ^,    j2O0i.2OOlSAWPtl.fM?. 
Trantftr  from  RSX  to  VMS  uting  D£Cn«t  VAX 

»    Fro«:       HALOIR-SMEPHARO    PASfMilllllNLl. f Ht« 

♦  To:  EXAMPLE.  Txr|||  ,      ■  -  mm 

Fiif  sawple.tt  wii*   tt  co»f##  tut  lAaai  tMyi  »a^a  **rf  •.*  .  . 

EHAHPlE  .  T:<  T  ,  ••»•»    ^P^    ♦#«•    «fl4    »#     ftf««4i«4 


(tiiliflusd  an  rwa!  p^gt} 


t« 


w 


Tranif«r  from  RSX  to  RSX  uting  OECn«t-RSX; 

NF  T    N00£  ¥  /  £  2^0  ♦  1 0 1  /  F ASS t  s  I  S to  J I  3i>  »$t>  1 S AWPt f  .  T K  f  J  2 

TU  UTIIITT  COIMNAIIO/MISSASf  fOUMATS 


S.ngli  mmigi  mod*        Tlk  [targ^tnode  |[TTfi  | 
D*a)og  mode: 


q^ 


<TlK         START  OF  DIALOG 


D«aiog  mod*  terminates  ^hen  e»f^«f  us«f  Npei   C'R  Z   Vi#io  dialog  m 
narmat  dtaiog  moo* 


♦^ 


#  »am#  procedures  to'  invoking  «rd  term  n«t  r  y  41  dOtV 


■lACW  11IIITMT ASK  CO«ll»OIIICATIO«  MACIW  CALLS 

?h«»  macro*  4f«  d«f>rHKt  m  MiTLft  MtS    Thm  «Mf)  aeau^  im%  m^  m^  c        ^  «  . 


m^flSS  •«€«fM 


Macro 


A8T| 


W>^^  1^  # 


functioafoimat 

A<;c«|»t  d  io^icm  urn  cofwiicf  n 


^si 


IfOl^mMMt  gflflilM  pipi 


ii 


CONS 


Request  a  logical  link  connection 
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CONB$$ 


DSC$ 


GLN$ 


GNDS 


lun\efn].{status]^ast].~  conbl.[conbien].[outoutfen]{ininf€n]   [  NOFl  OW] 
Build  connect  block  for  CON$  macro 
[noae].[ot)i].{tmt.    descnp   l^lrqid]  [   pass    \[.accno] 
Disconnect  a  logical  link  ^ 

li'n.[afn\.{statusl[ast]lQut,ou(len\ 
Get  local  node  information 
[fun]  [efn]  [status] J 'ist].   buf.Ouffen  ^ 
Get  data  from  network  data  queue 


[iun].[0fn].[status]\ast] 


{<.  mail  mien 
mail. mien  mask 
NTLON 
mask     NT  LON 


mask     NT 


OPN$ 


Access  the  network 


REC$ 


REJ$ 


SNO$ 


SPAS 


XMiS 


[lun]  [9fn\.[status].[ast][.   Nhksfrp.l 

Receive  data  over  a  logical  Unk 

lun.[efnllsMusl[ast]    Oufbuflen  . 

Reiecl  logical  link  connect  request 

[lun]  l9fn].[statusl[astl   mml,imanen][.out  outien] 

S  nd  data  over  a  logical  imli 

lun  {Bfn].[$tatus]  last]    bufbufitn 

Specify  a  user  AST  routine 

[lun].[9fn]  [status]  last]    aadr> 

Send  interrupt  r^essage  over  a  log.ral  link 

iun\9tn]\ittttus]\ast]    mt  mtfn  . 


(continued  on  next  fMigif 
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GND$  completion  returns  (defined  in  the  NSSYMS  macro  In  NETLIB  MLB): 


NT  ABO  Network  abort 

NT  ABT  User  abort 

NT  CON  Connect  request 

NT  DSC  User  d'sconnect 

NT  INT  Interrupt  message 


MACRO- 11  imiOII/COflNPLETION  COOES 


Applicable  Standard  RSX  Codes 


These  codes  are  defined  sn  the  lOERRS  macro   r^  RSXMAC  SMl   *h»c^  >$  referenced  in  me  NSSVM$  macro  'n  NETliB  MlB 


Oeci.Tial 

Octal 

Mnemonic 

Value 

Value 

IS  Sue 

% 

1 

IS  DAO 

t 

2 

IE  BAD 

•1 

37? 

IE  SPC 

^ 

%n 

IE  WLK 

-If 

304 

IF  DAO 

■   '  »1^' 

M 

IE  ABO 

-15 

:   m 

IE  PRi 

-1« 

wo 

Meaning 

The  request  ^as  successful 

The  reques?  wvas  successful   but  some  data  t^as  lost 

Invalid  buffer  parameter   or  data  lengt^  exceeds  16  t)vt»>s 

Invai'd  buffer  parar^ete's   buffer  ma^  '■>ot  be  word  aligned   buffe'  may  be  outside  user 
address  space  or  buf*er  '^av  e«ceed  8^28  bytes 

Transm.58  or*  of  an  m!#rrypt  r»  .       .  je  sfta^  attempted  before  tne  «a*t  orwt  fjn«<i^*»d 

Data  mmtun  unstofed  data  >%  >otf 

In#  t  nK  was  aborted  or  disconnected  (See  disconnect  and  retect  reason  codes  below) 


Th«  network   s  not  accessed  nr^  *^  s  UJN 


(contirHied  oi^  n#«t  pUfll 


IE  RSU 

-17 

IE  ALN 

34 

!E  NLN 

-m 

IE  URJ 

n 

IE  NRJ 

-74 

357 
336 

333 


?66 


Reqij  red  svstefr^  'BUHiretn  are  not  available 


The  spec'fted  LUN  s  already 


f^mn  >s  no  estaDi<sMKJ  logtcal  unk  or  the  spec  ^ed  I  UN 

The  '©f^ote  !a«*i  rejected  an  attempted  cohr>ecttor^ 

The  netwofli  fm0c^<^  an  attempted  conneclKm  {999  disconnect  and  reject  reason  c 
t>e(Ot«n 
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IE  NOA 


'8 


262 


There  is  no  data  to  '^eturr> 


IE  NNT 


U 


242 


The  issuing  tast>  >s  r^ot  a  n#tworli  Mtll,  OPN$  «as  not 


»Utw  f  ;>i'^;-ji 


04aconneci  and  fteiecl  Reason  C<>d«t 

These  codes  Ate  defined  m  the  NSS>M$  macro  n  NETuB  MiB 


SymlMl 

Decimal 

Octal 

PMItW# 

Value 

Vake 

NE$RES 

t 

t 

NESNOO 

1 

i 

Oiscor^r^ect  Reieci  Reason 


intuffic»*nt  networti  'eaourCM 


Unrecogn./ed  '  ode  ^'9f^9 


NEINSR 

3 

3 

NESUOB 

4 

4 

NE$fMT 

*.:;::• 

'«' 

NESMli 

/:•:-: 

t 

NESABM 

^•' 

«t 

NESNNP 

m 

ft 

NESNSU 

n 

It 

NE$ACC 

^m  ^ 

# 

NESA80 

:./•■., 

;  «i 

NESCOM 

■■■■'»•■' ; 

"^^^^^' 

i'*»rr>ot«  node  shutting  down 


Ami*  conffoi  r«t#c^(}  Ot»  ^•«tsot«  noa«  ur  al3»|»«t 


^? 


CAlit  fm  flMTlAat  COMK  kflO  lASIC  PIUS  1 


«• 


FORTRAN 


CAiL  XXX  A  A  .j^/<i/n#f#/S) 


COBOL 


CAU     XXX AX    USlMG  p«<4m«r«/s 


BASIC   PLUS-a 


CAtl  XX XXX  B>  ni^  tfM|/«i^*«f«^t» 


Inttrtifth  Communication  Callt 


thi»5e  :  i »»  if«  69^m^  m  NiTf  OW  OlB    T**.    a 
BFMTO   BfMTi    and  \IVAlTNT  <•  9    ABTNT^t 


can  b«  so^cNk)  hv   t 


any  o* 


t» ,.  » 


#•  #c»  BACC 


Call 


Function  Format 


AuTNT 


AOort  a  M>g»ail  Uf^ 


km.ia^kt9\{  Out%it0  uv..  ;  4;.«a^j 


ACCNT 


iifiii 


ktn  {9tmfy9\ 


Oi^t%>i9 


BACC 


BFMTO 


BFMT1 


CLSNT 


CONNT 


DSCNT 


Build  access  control  information  area 

[status]Jgtblk  [usersz  user\.[passwdsz  passwcl][.accnosz.accno\ 

Build  a  format  0  destination  descriptor 

[status]  Jgtblk.nds2,ndndme,obit^p9 

Build  a  format  1  destination  descriptor 

[status].tgtblk  ndsz.ndname.cbitype.namesz,name 

End  a  task's  network  operations 

[sfafus] 

Request  a  logical  link  connection 

fun, [status]  jgttlk[outsiiBOutm9SS§g9]\  insfi9  inm^ssag^] 

Disconnect  a  Ic  jcal  link 

lun, [status]], outsize, outmossMga] 
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GLNNT 


30 


GNDNT 


OPNNT 


RECNT 


REJNT 


SNDNT 


Get  local  node  information 

[status]  butien. but 

Get  data  from  network  data  queue 

[status]  type  [mdiisi\[maiit)uf]  [itonlYl,[,mmeJ][.typmskl 

Access  the  network 

lfun].\status]lmstat]  lcount]{  trp] 

Receive  data  over  a  logtcaf  hnk 

lun  [status]. msit*  indata 

Reiect  logical  iinn  connect  request 

[status]. mailbutl,^t5ii9  0utm9ssag9] 
Send  data  over  a  logical  imH 
tun[status].outsii9outaat0 


^     * 


WAITNT 


XMINT 


Suspend  the  calling  task 
[ind9M].status1  itatusn 
Send  interrupt  message  over  a  logical  link 


'un.[status\.intsiz9  intmsg 

Ci^UNl  cumpl«iion  r«turnt: 

t  Connect  request 

'a*  Interrupt  message 

3  User  disconnect 

4  iN^twcrw  abort 

5  User  abort 


it 


R«mot«  File  Access  Calls 
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Call 

ACONFW 


ATTNFW 


CLSNFW 


DElNFW 


EXINFW 


Function  Format 

Set  file  access  options 

{lun.status{fac\[shr][fop]\ 

Set  eAtended  aundutes 

Vun,$tii(us.indm6Si/9\.{name\[att]  [protblk]  {omn9r\\aat90ik\y 
Close  a  file 

{lun, status  [changeattrl[top\\ 

Delete  a  file 

{tun  status  node  ident  itii0\ 

Execute  a  ftle 

{lun  status  node  I  dent  ifffe) 


GETNFW 


Raad  a  tmgle  record 


OPANFW 


OPMNFW 


OPRNFW 


OPUNFW 


OPWNFW 


Op«n  and  .ippefvd  ft||9lliMlil  Mi 

(/un  sfa/us  ooiie  fd#nr /ff/# /C^#/./«f}4^g,l0^^ 

Open  and  modi'y  a  s«( 


(/yn  sfarus  noctw  lO^nt  iftim  ich^r  mn  [/£Moc*]| 
Ope'   And  read  •filM^^t'ai  ^>t# 


\funsftus  no^Mli^r  ''>•'•  'Ciar  ^•n  [>btock\\ 
^MW  and  updat*  a  s#quer>^a♦  ».»# 
ftefi  «fiifi/f  noai  im^t  if$f9  >ch4ff9f*  pbheli}) 
Cf«At«   op#o   and  «rrrf«  «  tifiitiliil  lUi 


l^n  $t9tu»  noomxfnt  firg  ili||:iii|iiml"' 


nu«d  ur^  n#it 


» 


PRGNFW 


Discard  «n  op«n  r«i« 


^yn.sutusi 


PUiNFT 


Mril«  a  r«cata  to  4  tu« 


i/wft  s|«ru«. 


l'»iW^iilpi14«#l* 


RENNFW 


SPLNFW 


SUBNFW 


{lun  stBtus  nofSm  xHnt  ohm  ntiimi 

«rr>t«   and  prtnt  «  hm 
{lun  st»tu%  nod*  cfmnt  >ftf9  tc^f  ff*  [ttmctil) 

m'^9  and  •K«cut«  a  ti(« 


FORTRAN  Tatli  Control  Calli 


B«fOf«  issuing  4  FORTRAN  Unk  confro*  call    vou  my»l  acCMS  m*  HiMHWit 
Op«f4tions    trOU  mull  d««CC«SS  !h#  n#t,(iiofh  0|  »i»M»n||  tn#  CkSI^T^  caii 


il  4«i««t^  m«  OP^fiiiTVi  ^n  mt*m  fm  m^^m  mutt  mt^fm 


Call 


ABOfCW 


BACUPI 


RUNNC^ 


Function  format 


Abort  «in  i»t«cut«n9  tush    .'  canc«}  a  icf)««fuiaa  imH 

(^^  ifl|lpi#NMif  m»nm  past i*c^s«/  i>aai«^  •»*«^#  fM/ia'^  i/{la#»f||  ms*M^ 


♦|aiiii^|.lMi#rtf  utaf  If  accf»ot#  accwof) 
t»acuf»^  »>^  I'miiiii  tin  m  #  iiim»ia  mm 


0MI>fifti^9}«INiif.A4S^tfl*i 


AMiarir  ft*i«i  ^  -     •  *»1*i|rtl||*lC|J»m0  •nffl  rmg  mff| 


ERROR/COMPLETION  COOES  FOR  FORTRAN.  COiOL.  AND  lASIC^lUS^Z 


M 


Intertask  Communication  FORTRAN  Task  Control  Error  Codes 


2 
-1 
-2 
-3 
-4 
-5 
'6 
-7 

8 


The  request  was  successful. 

The  request  was  successful   but  some  data  was  lost 

HtQuired  system  resources  are  not  available 

th#fe  IS  no  established  logical  link  on  the  specified  LUN 

The  link  was  aborted  or  disconnected 


Data  Overrun   unstored  data  is  lost 


Invalid  buffer  parameter   or  data  length  exceeds  16  bytw 

No  data  was  found  m  the  user  s  network  data  queue 

The  network  rejected  an  attempted  connection 

A  logical  link  has  already  been  established  on  the  specified  LUN 


-9 

-10 

-11 

-12 
-13 
-14 
-20 
-21 

-23 
-24 


The  issuing  task  is  not  a  network  task:  OPNNT  was  not  executes'  successfully 

The  user  ts  attempting  to  access  the  network  i^-.a  OPNNT)  for  a  second  time 

Transmission  of  an  interrupt  message  was  attempted  before  the  last  one  fmisned 

The  remote  task  reiected  the  connection 

A  buffer  IS  outside  user  address  space  or  is  not  word  aligned 

A  second  GNDNT  has  been  attempted  ^hen  one  ts  already  pending 

A  RUNNCW  was  issued  fur  which  there  ^as  not  enougn  dynamic  memory  on  the  remote  node 

A  RUNNCW  or  ABONCW  was  issued  tor  a  task  that  was  not  installed  on  tne  remote  node 

A  R'JN^JCW  was  iscucd  with  an  invalid  time  parar^eter 

Either  an  ABONCW  was  >ssued  for  a  task  that  was  not  active  or  a  RUNNCW  without  scheduling  parameters  was  ssued  for  a  task 
that  IS  already  active. 


There  was  a  privilege  violation  on  a  RUNNCW  or  ABONCW  attempt 
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-25  An  ABONCW  was  issued  for  a  task  that  either  was  bemg  loaded  into  or  was  ex^t-ng  from  the  remote  node 

-26  A  RUNNCW  was  issued  w.th  an  invalid  UIC* 

-40  A  directive  error    the  second  word  ot  the  status  block  contains  me  actuaf  d-rectlve  error  code  (see  the  RSX   ruf  M  PLUS 

tMecuttye  Reference  Manual), 

Rcmolt  Fii«  Acctts  Error  Cod«t 


1 

-1 
2 
3 


The  request  was  successful 

The  LUN  on  which  the  request  was  made  IS  dctfve. 

The  LUN  on  which  the  request  was  made  IS  tnactiv©. 

The  remote  system  detected  a  data  access  protocol  error   The  second  word  of  the  I  0  status  block  contains  the  DAP  maccode  and 
miccode  values 

A  network  error  was  detected  during  the  operation 

The  second  status  word  contains  the  ntertask  error  code 


5 

6 
-7 

8 

9 

-10 
-11 


Invalid  attributes  have  been  specified  in  an  open  command 


A  data  overrun  occurred  on  the  user  buffer 


Th«  requesting  task  and  the  File  Access  Listener  «FALl  are  out  of  sync. 
An  invalid  LUN  watt  used  tn  the  tile  access  call 


A  buffer  allocation  failure  occurred 


A  directive  error  occurred 


An  illegal  request  was  made 
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OU  QIO  FUNCTIOM  cooes 

Ustng  build  type  m^cro.      l^tim   QiO,W|$  10  *»n   paramet^fs 
Using  stacK  type  macro      QlOlWilS  10  «««  ptf'^a'^tft'f 

DLX  requests  conform  to  normal  RSX   ^  1  QlO  standafiis    Th©  QiO  Ma*t  option   s  valid  tor  ad  OLX  function  codes  Codes  appi>  to  both  non- 
Etf^ernet  and  Ethernet  devices   unlets  otherw^i»e  noted    Tr^ese  todes  ar^  defir>#d  tn  tf>e  DLXOFS  macro  m  NETLiB  MlB 


Code 


Function  Format 


10  XOP 


Open  a  Ime 


010$  10  XOP  lun  [9tn]  [status]  fasf]    pi  p2  p3 


•oxsc 


Set  character isflcs  (Ethernet  only) 


OlO$  lO  XSC  fun  (e^r^l   (sfafust  liifl    pt  0t> 


iOXGC 


Get  characteristics  (Ethernet  onty» 


OiOS  iO  XQC  /un  [9fn\  [»ftu»\  [0$t\    pi  p2 


10  XIN 


10  XTM 


10  XRC 


lO  XHd 


10  XCL 


ln(t»«»ii/e  th|?  itr)«  {non  Elhurnet  only) 

Q!0$  lo  XIN lun  i#Mi  i$mmi[mai  fit. 

transmti  a  message  on  the  Un$ 

OiO$  10  XTM  lun  i^\,ymmU^9n    fi'.p2{  p3 p4| 


Receive  a  mi 


on  the  lin# 


010$  »0  XRC./un  {e^n}  (sfafusj  {«if|    pi  p2f  p3  p4j  . 
Hanq  up  the  fine  (non-Sthefnet  ontyj 

oio$  lo  XMQ /ii«  tt^j.,jiiiifMt!  rutn 


Qioi  io  JiCi^itft4ifi|4itrtKit4ti^ 
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OIK  IMOR  COMPUTIOH  STATys  lUTUflNS 


SymboJ 

Nam* 

issue 


t-lt) 


Oct«i 

V#lMt 

I 


If  TMO 

tH> 

iffwi 

'f  NlH 

i-^  1 

»n?33 

*^  ^H 

1  W> 

t^?r3« 

»f  RSU 

t   tfi 

ffffm 

it  PUT 

i-m^ 

ifff^ 

»t  ABO 

>H^ 

iff  Hi 

»*«€4ttsOfl  l»f-t?«<    o#  rH#  *|3WC^i#d  *^f^  ft.  wot  'r» 


lEDAO 


(-13) 


177763 


A  message  is  received  before  a  receive  QIO  is  issued,  or  the  user  buffer  is  too  small  to 
receive  all  of  the  data 


lESPC 


IE  VER 


(-6) 


i-4.) 


177772 


177774 


The  transmit  ouffer  is  too  large  (applies  only  to  POP   1 1  44  or  POP  -1 1  '70  with  extended 
memory) 

An  error  has  occured  on  the  line 

The  second  word  of  the  I/O  status  block  contains  the  error  code   Possible  error  codes 
are. 


lE.ONR 
lE.IFC 


© 


(-3) 
(-2.) 


100361 

100362 

100363 

100364 

100366 

100370 

100372 

100374 

100376 

177775 

The  hai 

177776 

The  LU 

DDCMP  transmit  error  threshold  exceeded 

Operation  aborted 

Message  received  vvithout  receive  pending 

Start  received 

Line  physically  dtsconnected 

General  error 

MOP  message  received 

DDCMP  reply  timeout  threshold  exceeded 

DDCMP  receive  error  Ihreshoid  exceeded 


The  hardvvare  device  v^as  not  ready   The  line  was  hung  up  and  has  not  been  retnitiaii/ed 


The  LUN  is  not  assigned  to  NX 
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10  XSC  C.STAT  Error  Codes  for  the  Ethernet 
error  Code  Meaning 


1 0000 1 
CEUDF 

100003 
CE  RTL 

100004 
Ct  -«TS 

100007 
Ch"  MCE 

100010 
CE  RES 

100C11 
CEPCN 


Undefined  function 


Request  too  large 


Request  too  small 


Multicast  address  already  enaDied 


Resource  allocation  failure 


Protocol  usage  conflict 
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100012 
CE  ACN 

100013 
CEIUN 


Address  usage  conflicts 


Illegal  use  of  multicast  address 


100014 
CENMA 


Not  a  rriulticast  address 


4ft 
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ObJAct  Type 

Octal  Decimal 


Procais  Typt 


000 

000 

001-016 

001  014 

017 

015 

020 

016 

021 

017 

022 

018 

023 

019 

024-026 

020  022 

027 

021 

General  task    user  process 

Reserved  tor  OECnet  use 

R3X-11M  Remote  Tash  Control  utility  (TCL)  -  Version  2 

TLK  utility  (LSN) 

File  Access  Listener  (FAL  DAP|  -  VersiOn  4  and  later 

RSX- IIS  Host  Loader  utility  (MLD) 

Network  information  and  Control  Encr^ange  iNlCE) 

Reserved  for  DECnet  use 

Network  command  termmat  ^andler  -  host  s-de  (RMHACP) 


030 

034 

031 

025 

032 

026 

033-076 

027  062 

077 

063 

100  177 

064-127 

200-377 

128  255 

Reserved  tor  DEC  net  u< 


loopback  mtrror  (MIR) 


Event  receiver  iEVR» 
Reservetl  for  DECr>et  use 


DECne?  test  tool  iDTRi 


Reserved  for  DECnet  control 
P^NWrved  for  customer  use 


^ 


